
MVS/Extended Architecture 


Media Manager 


Diagnosis Reference 


Licensed 

Program 



Order Number LY26-3965-1 
File Number S370-37 


Restricted Materials of IBM 
Licensed Materials—Property of IBM 
© Copyright IBM Corp. 1980, 1987 


Data Facility Product 5665-XA2 
Version 2 
Release 3.0 




MVS/Extended Architecture 
Media Manager 
Diagnosis Reference 


Licensed 

Program 


Order Number LY26-3965-1 
File Number S370-37 


Restricted Materials of IBM 
Licensed Materials—Property of IBM 
© Copyright IBM Corp. 1980,1987 


Data Facility Product S665-XA2 
Version 2 
Release 3.0 




Restricted Materials of IBM 
Licensed Materials - Property of IBM 


Second Edition (June 1987) 

This is a major revision of, and makes obsolete, LY26-3965-0 
(formerly titled MVS/XA Media Manager, Diagnosis ouide and 
Reference)• 

This edition applies to Version 2 Release 3.0 of MVS/Extended 
Architecture Data Facility Product, Licensed Program 5665-XA2, 
and to any subsequent releases until otherwise indicated in new 
editions or technical newsletters. 

The changes for this edition are summarized under "Summary of 
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PREFACE 


MVS/Extended Architecture Media Manager Diagnosis Reference 
discusses the functions performed by the media manager and how 
they relate to each other. It helps you to use symptoms to 
narrow the area of the media manager program to be examined* and 
to associate problem symptoms with specific functions. This 
information will assist you in supplying helpful detail when 
reporting new problems to the IBM Support Center. 


| ORGANIZATION 

I This book is organized as follows* 

Chapter 1* "Program Overview" on page 3* gives an external 
overview of the media manager program and each of the functions 
it performs. 

I Chapter 2* "Program Functional Description" on page 5* describes 

the functional area of the media manager program product. This 
includes the function-to-function relationships* and the 
principal processing paths through each of the functions. 

| Chapter 3* "Module Directory" on page 9* provides a media 

manager module-to-module cross reference. 

I Chapter 4* "Control Blocks and Data Areas" on page 12* describes 

the control blocks and data area linkages used by the media 
manager. 

| Chapter 5* "Service Aids" on page 30* contains a description of 

the media manager dump and its output. It also describes 
diagnostic tools that can be used to collect information on 
program failures. 

Appendix* "Return Codes" on page 32* lists the return codes that 
are provided when errors occur. 

"List of Abbreviations" on page 34* defines the abbreviations 
used in this book. 


PREREQUISITE KNOWLEDGE 

In order to use this book efficiently* you should be familiar 
with the following topics for system control programs* 

• Dump analysis 

• Diagnostic practices 
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Within the text/ references are made to the publications listed 
in the table below: 



Short Title 


Debugging 

Handbook 


Programming 

System 

General 

Information 


Service Aids 


Supervisor 
Services and 
Macro 

Instructions 


System 

Messages 


Utilities 


Publication Title 



through 5 


, Volumes 1 



Order 

Number 


LC28-1164 1 

LC28-1165 

LC28-1166 

LC28-1167 

LC28-1168 


6229-2228 


GC28-1159 


GC28-1154 


GC28-1376 

and 

GC28-1377 


GC26-4150 


All five volumes may be ordered under one order number/ 
LBOF-1015. 


t 
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SUMMARY O F C HANCES 


| RELEASE 3.0, JUNE 1987 

The procedural diagnosis information in this manual has been 
moved to the new MVS/XA Data Facility P roduct Version 2t 
Diagnosis Guide . Consequentially, the title has been changed to 
indicate that the manual now contains only diagnosis reference 
information. 


| NEW ENHANCEMENTS 

Information was added to "Data Areas" on page 18 and the 
Appendix, "Return Codes" on page 32, for support of linear data 
sets. 


RELEASE l.Qt APRIL 1985 


NEW ENHANCEMENTS 


• The release level keyword, which was optional in earlier 
releases, is now required. 

• Return codes for common errors have been added in the 
appendix. 


VERSION 2 PUBLICATIONS 

The preface includes order numbers for Version 2 books. 
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INTRODUCTION 


| This publication describes the media manager in terms of its 

functions. For purposes of this publication* function is 
defined as a logically distinct group of modules that performs a 
major part of a program's processing. 

| This publication is not intended to show you the procedural 

steps involved in diagnosing a media manager problem* nor how to 
modify or repair the program logic. It will* however* give you 
an adequate basis for communicating with an IBM program 
specialist about possible program failures. 


| ORGANIZATION 

The information contained in this book is organized to support 
the diagnostician in analyzing the process being performed. 

| This book is organized as follows* 

"Program Overview" on page 3 presents an overview of the media 
manager* its purpose* and its functions. It is intended to 
provide a quick grasp of the processing performed by the media 
manager. 

"Program Functional Description" on page 5 describes the 
principal processing paths through each function. 

"Module Directory" on page 9 shows the module-to-module 
communication and the functions and sub-functions in which the 
module is involved. A brief description of each module is also 
included. 

"Control Blocks and Data Areas" on page 12 describes key data 
areas used for communications between the functional areas* and 
shows the data area linkages. 

"Service Aids" on page 30 contains descriptions of dumps and 
describes how to analyze diagnostic information for this 
product. 


HOW TO USE THE REFERENCE MATERIALS 

The following sections explain how to look for information that 
pertains to a specific function or module. 


FINDING THE MODULE IN A FUNCTION 

To find out what module carries out a specific function* follow 

these steps* 

1. Under "Program Functional Description" on page 5 and under 
the function heading you have chosen* find the name of the 
controlling module and the modules it calls in the 
processing sequence. One of these modules is likely to 
contain the code you are looking for. 

2. If you want to know which modules call and are called by the 
particular module* look at the entry for that module under 
"Module Directory" on page 9. 

Let's take an example. Suppose you want to know what module 

builds the channel program for a read request. 

1. Under "Program Overview" on page 3* find the function 

0P = RDWR in Figure 1. The description of 0P=RDWR states that 
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this function processes reads and writes for the data 
portion of records. 

2. Under "Program Functional Description" on page 5* find the 
section on the RDNR function. 

3. Look at the descriptions of the controlling module and the 
modules called to perform the RDHR function. The module 
ICYBLDCP is likely to be what you are looking for. 

4. If you want to see which modules call ICYBLDCP or which 
modules it calls* find the entry for ICYBLDCP under "Module 
Directory" on page 9. 


FINDING THE FUNCTION OF A MODULE 

If you want to gain a general understanding of the context (or 

area of function) within which a module operates* the modules 

that call this module* and what they do* follow these steps. 

1. Under "Module Directory" on page 9* opposite the name of the 

module you are interested in* find the names of the 
functions it participates in. 

2. See the descriptions of the functions in "Program Functional 
Description" on page 5. 

3. If you want a more general view* see Figure 1. 

For example. If you wish to find out what media manager function 

uses ICYBLIST* do the following: 

1. The entry in "Module Directory" on page 9 tells you that it 
is used by the RDWR and FMTWR functions. 

2. A description of the functions is in "Program Functional 
Description" on page 5. 
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PRQgRAMJPyjERyiEM 


This section presents an overview of the media manager program* 
its purpose* and its functions. It also describes how the media 
manager interacts with other programs. 

The media manager is a component of the MVS/Extended 
Architecture Data Facility Product (MVS/XA DFP)* Program Product 
Number 5665-XA2. 

It enables a caller to use relative byte addresses in requests 
to read and write data* and to pre-format a range of relative 
byte addresses on a direct access storage device (DASD). Nith 
relative byte addressing* the caller is independent of the 
device architecture and the channel programs required for I/O. 

The media manager performs the following services! 

• The INIT function builds and initializes the control blocks 
required to perform I/O. 

• The RDWR function reads or writes the data portion of a 
logical record (control interval) on a DASD device. 

• The FMTWR function writes count fields and data sequentially 
on a DASD device. 

• The PFMT function pre-formats one or more DASD devices for a 
range of relative byte addresses. 

• The CNVT function changes relative byte addresses to 
absolute device addresses (CCHHR)* and vice versa. 

• The MMSYSTEM function manages media manager resources. The 
modules used by the MMSYSTEM function aret ICYELE* ICYFRR* 
and ICYPURG. In addition* a system function manages media 
manager resources* 

• The SRV function interfaces with the integrated catalog 
facility catalog to obtain data set information and to 
update that information when explicitly requested. 

Macros issued by the calling program invoke most media manager 
functions. There are four macros! MMINIT* MMCALL* MMSRV* and 
MMCNVT. Figure 1 on page 4 shows the functions invoked by each 
of the macros and the controlling module for each function. 
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MMXNXT macro MMCNVT macro 


ICYINIT 


ICYRBA/ 

ICYCCHHR 


Initializes 


Converts RBA to j 

media manager 


CCHHR and 
versa 

vice 


INIT function CNVT function 


MMCALL macro 


OP-RDHR 


ICYRDWR 


Reads and 
update-writes 
data portion 
of records 


RDMR function 


0P=FMTWR 


ICYFW 


Formats, 
tracks, and 
writes data 


FMTWR function 


OP=PFMT 


ICYPFMT 


Preformats an 
RBA Range 


PFMT function 


MMSRV macro 



CONNECT 

function 


DISCONNECT EXTEND 

function function 


CATALOG READ CATALOG UPDATE 

function function 


Figure 1. Functions Invoked by Media Manager Macros 
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PROGRAM, FUNCTX.OMAL_DESCRIPTION 


This section describes the principal processing paths through 
each function and describes how the functions interact with each 
other. The functions are arranged alphabetically for easier 
reference. 

From this section, you can relate external input to the 
processing of a function. The functions named in this section 
are those described in "Program Overview" on page 3. 

The names of the functions are the titles of the main parts of 
this section. Under each function name is the description of 
the functions operation, as follows: 

INPUT: Describes the input requirements for the function. 

PROCESSING: Describes the processing the function performs. 

RESULTS: Describes the results or output consequent to the 

execution of this function. 


CNVT FUNCTION 

INPUT: Register 0 for ICYCCHHR points to the UCB for the device 

containing the extent. 

Register 1 points to the convert parameter list (ICYCPL). 

The controlling modules are ICYRBA and ICYCCHHR. 

PROCESSING: On receiving control, ICYRBA (or ICYCCHHR) proceed 

as follows: 

• ICYRBA converts RBAs to CCHHRs. 

• ICYCCHHR converts CCHHRs to RBAs. 

RESULTS: RBA or CCHHR conversions are processed as specified in 

the calling program f s request. 


FMTWR FUNCTION 

INPUT: Register 0 contains parameter information. 

Register 1 points to the first element (MMRE) of an I/O request. 

Register 2 points to the MMIB. 

The controlling module is ICYFW. 

PROCESSING: On receiving control, ICYFW proceeds as follows: 

• Calls ICYSTOR to acquire work space and build the MMPB, 
indicating that requests are for format-write 

• Establishes a functional recovery routine (FRR) 

• Arranges the request elements in the chain in RBA sequence 

• Calls ICYBLIST to build a list of control interval elements 
suitable for RBA-to-CCHHR conversion and channel program 
build 

• Calls ICYRBA to convert RBAs to CCHHRs 

• Calls ICYBLDCP to build I/O control blocks and channel 
programs 
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• Passes control to the I/O supervisor via the STARTIO macro 
to start input/output 

• Returns to the calling module/ and the I/O continues 
asynchronously 

Hhen the I/O is completed/ ICYDIE/ICYNRM receives control/ 
releases storage/ and returns to the calling program via 
ICYPGAD/ depending on the return code from the calling program's 
DIE exit. 

Hhen the I/O fails/ ICYABN receives control and returns to the 
calling program always via ICYPGAD. 

RESULTS: Format write requests are processed as specified by 

the calling program. 


INIT FUNCTION 


INPUT: The INIT function requires/ as input/ certain DASD 

device characteristics such as tracks per cylinder/ bytes to be 
used on a track/ and starting and ending device addresses for 
each extent. 

Register 1 points to the calling program's parameter list that 
contains information needed to build EDBs and LPMBs. 

The controlling module is ICYINIT. 

PROCESSING: On receiving control/ ICYINIT proceeds as follows: 

• Builds extent definition blocks (EDBs) and 
logical-to-physical mapping blocks (LPMBs) as required for 
each extent for each volume entry specified 

• Uses information in device blocks describing the physical 
characteristics of the data set and the device to construct 
LPMBs 

• Initializes the media manager interface block (MMIB) with 
the addresses of the EDB and LPBM storage 

RESULTS: The MMIB is now complete for processing calling 

program requests. 


MMSYSTEM FUNCTION 


INPUT: (No input used) 

PROCESSING: The MMSYSTEM function proceeds as follows: 

• ICYELE waits for notification from the system resource 
manager of a low system queue area (ESQA) condition and 
frees unused media manager storage. 

• ICYFRR records information in the SYS1.L0GREC and 
SYSl.DUMPnn data sets for indeterminate errors or system 
X'COD' abends within the media manager. 

• ICYPURG releases system resources held by the media manager 
or VSAM when a PURGE HALT request is received. 

RESULTS: (No output produced) 
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PFMT FUNCTION 


INPUTs Register 0 contains parameter information. 

Register 1 points to the I/O request element (MMRE). 

Register 2 points to the MMIB. 

The controlling module is ICYPFMT. 

PROCESSINGS On receiving control* ICYPFMT proceeds as followss 

• Calls ICYSTOR to acquire work space and build the MMPB 

• Establishes a functional recovery routine (FRR) 

• Calls ICYPFCP to set up a channel program to format a track 

• Builds the I/O control blocks to interface with the I/O 
supervisor 

• Passes control to the I/O supervisor via STARTIO macro to 
start I/O 

• Returns to the calling module* and I/O continues 
asynchronously 

On return from the I/O supervisor (IOS)* ICYPFDIE calls ICYPFCP 
to format another track. If another track is required* ICYPFDIE 
re-drives the IOS. If finished, ICYPFDIE schedules ICYPGAD to 
return to the calling program. If an error occurs* ICYPFAPP gets 
control Cin order to interface with user error routines* if they 
exist) before returning to the calling program via ICYPGAD. 

RESULTSt Pre-format requests are processed as specified by the 
calling program. 


RDWR FUNCTION 


INPUTt Register 0 contains parameter information. 

Register 1 points to the first element (MMRE) of an I/O request. 

Register 2 points to the MMIB. 

The controlling module is ICYRDWR. 

PROCESSING: On receiving control* ICYRDMR proceeds as follows! 

• Calls ICYSTOR to acquire work space and build the MMPB that 
keeps track of read/write processing 

• Establishes a functional recovery routine 

• Calls ICYSORT to sort the request elements in the calling 
program's request by relative byte address for efficiency of 
input/output* if specified by the calling program 

• Calls ICYBLIST to build a list of control interval elements 
suitable for RBA-to-CCHHR conversion and channel program 
build 

• Calls ICYRBA to convert RBAs to CCHHRs 

• Calls ICYBLDCP to build I/O control blocks (SRB and IOSB) 
and channel programs 

• Passes control to the I/O supervisor 

• Returns to the calling module* and I/O continues 
asynchronously 
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Hhen the I/O is completed# ICYDIE/ICYNRM receives control# 
releases storage# and returns to the calling program via 
ICYPGAD# depending on the return code from the calling program's 
DIE exit. 

When the I/O fails# ICYABN receives control# and returns to the 
calling program# always via ICYPGAD. 

RESULTS: Read/write requests are processed as specified by the 

calling program. 


SRV FUNCTION 


INPUTs The SRV function consists of five sub-functionss 
CONNECT# DISCONNECT# EXTEND# CATREAD# and CATUPDT. The media 
manager services parameter list (MMSPL) contains the DDNAME 
specification or the specification for the data set or a valid 
parameter list for sub-functions other than CONNECT. This MMSPL 
list is required as input. Register 1 points to the calling 
program's parameter list. 

PROCESSING: On receiving control# ICYMMSRV proceeds as follows: 

• Builds the media manager services work area (MSWA) 

• Creates a dummy ACB to interface with VSAM 

• Calls VSAM for CONNECT# EXTEND# DISCONNECT 

— Issues SVC 26 to obtain or update required catalog 
information 

— Returns to calling program 

RESULTS: The sub-function is complete or a return code is 
passed to the calling program. 
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MODULE DIRECTORY 


This section shows the module-to-module communication within the 
program. Module information is organized alphabetically and is 
useful when following the flow between modules and when 
verifying what processing has taken place. The following table 
lists all media manager modules, and gives for each modulei 

• The functions to which it belongs 

• The names of the modules by which it is called 

• A brief description of what it does 

• The name of the modules it calls 

• The name of the module to which it exits 

In both the "Called by” and the "Calls” column, a name in 
parentheses refers to another system component, as follows: 


ZOS I/O supervisor 

SRM system resource manager 

ENF event notification facility 

VSAM virtual storage access method 

VSM virtual storage manager 

Le.qs.nd-L 

< > Indicates an indirect call by scheduling an SRD. 
t ] Indicates a branch. 


Module 

Function 

Called by 

Description 

Calls 

Exits to 

ICYABN 

RDWR 

FMTWR 

(IOS) 

IOS interface, 
abnormal end append¬ 
age 


IOS +(0 
or 8) 

ICYNRM 

ICYBLDCP 

RDWR 

FMTWR 

ICYDIE 

ICYFW 

ICYP6AD 

ICYRDWR 

Builds channel 
program 

ICYSTOR 

calling 

program 

ICYBLIST 

RDWR 

FMTWR 

ICYFW 

ICYRDWR 

Builds a list of 
control interval 
elements suitable for 
RBA conversion and 
channel program build 

ICYSTOR 

calling 

program 

ICYCCHHR 

CNVT 

PFMT 

ICYPFAPP 

Converts device 
address to relative 
byte address 


calling 

program 

ICYDIE 

RDWR 

FMTWR 

(IOS) 

Interface between IOS 
and calling program's 
DIE routine for 
read-write and 
format-write requests 

ICYBLDCP 

<ICYPGAD> 

ICYRBA 

ICYSTOR 

IOS +(0, 

4 or 8) 
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Module 

Function 

called by 

Description 

calls 

ICYELE 

MMSYSTEM 

(SRM, 

ENF) 

Upon notification from 
ENF/ frees media 
manager stoi— 
age blocks 


ICYFRR 

MMSYSTEM 

(RTM) 

Functional recovery 
routine 


ICYFW 

FMTWR 


Processes format-write 
requests 

ICYBIDCP 

ICYBLIST 

ICYRBA 

ICYSTOR 

ICYIEDB 

INIT 

ICYINIT 

Builds extent defi¬ 
nition block 

ICYILPMB 

ICYILPMB 

INIT 

ICYIEDB 

Builds 

logical-to-physical 
mapping block 


ICYIMIT 

INIT 


Initializes media 
manager control blocks 

ICYIEDB 

ICYMMSRV 

SRV 


Access the integrated 
catalog facility 
catalog to build a 
media manager control 
block structure 

(VSAM) 

ICYMSTAE 

SRV 

(RTM) 

ICYMMSRV ESTAE routine 


ICYNRM 

RDWR 

FMTWR 

EICYABNI 

(IOS) 

IOS interface/ normal 
end appendage 


ICYPFAPP 

PFMT 

(IOS) 

IOS interface, 
appendage that pre¬ 
formats by RBA range 

ICYCCHHR 

ICYPFCP 

PFMT 

ICYPFMT 

ICYPFDIE 

Builds channel pro¬ 
gram to preformat 
within an RBA range 

ICYRBA 

ICYSTOR 

ICYPFDIE 

PFMT 

(IOS) 

Interface between IOS 
pre-format func¬ 
tion for redriving I/O 
until all tracks are 
formatted 

ICYPFCP 

<ICYPGAD> 

ICYPFMT 

PFMT 


Processes requests to 
pre-format within an 

RBA range 

ICYPFCP 

ICYSTOR 

ICYPGAD 

RDWR 

FMTWR 

<ICYDIE> 

<ICYPFDIE> 

(IOS) 

IOS interface, 
termination routine 

ICYBLDCP 

ICYRBA 

ICYSTOR 

ICYPURG 

MMSYSTEM 

(IOS) 

IOS interface/ purge 
routine 


ICYRBA 

RDWR 

FMTWR 

PFMT 

CNVT 

ICYDIE 

ICYFW 

ICYPFCP 

ICYPGAD 

ICYRDWR 

Converts relative byte 
address to CCHHP. 
address 
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Module 

Function 

Called by 

Description 

Calls 

Exits to 

ICYRDWR 

RDWR 


Processes read and 
update-write requests 

ICYBLDCP 

ICYBLIST 

ICYRBA 

ICYSORT 

ICYSTOR 

calling 

program 

ICYSORT 

RDWR 

ICYRDHR 

Sorts I/O request 
elements for 
input/output 
efficiency 


calling 

program 

ICYSTOR 

RDMR 

FMTHR 

PFMT 

ICYRDWR 

ICYFW 

ICYPFMT 

ICYBLIST 

ICYBLDCP 

ICYDIE 

ICYP6AD 

ICYPFCP 

Acquires space in main 
storage for the media 
manager 

(VSM) 

(lock 

manager) 

calling 

program 
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This section describes the data areas (control blocks) used for 
communication between functions, programs, or parts of the 
system. This information is useful for interpreting storage 
dumps and for determining the program's and system's status at 
the time of failure. Only those data areas are documented that 
contain fields that direct processing from one function to 
another. 

The media manager uses control blocks and data areas to map 
relative byte addresses to the actual device address. The media 
manager also builds internal control blocks to allow control of 
the I/O process and to maintain storage that is allocated to the 
media manager. 

Hhere appropriate, key data areas have been provided. These are 
listed following the related control block. 

Media manager functions use control blocks and data areas as 
follows* 

Functions Data Areas 

IMIT EDB, IDEVB, IPLST, LPMB, MMIB 

RDWR, EDB, LPMB, MMIB, MMPB, MMPT, MMRE, MMSB, 

FMTWR, MMSV, MMVR 

PFMT 

CMVT CPL (part of MMPB for use by media manager; 

separate data area for calling programs) 

SRV MMSPL, MSWA 

Note: The prefix ICY is part of the mapping macro names on 
microfiche. 
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Figure 2 shows a control block chain for initialization; 
Figure 3 on page 14 shows a control block chain for I/O 
processing. 


Register 1 


I Initialization 
V parameter list 


04(04) 


MM interface 
block 


16(10) 


Extent 

definition block 



a MMIB 

Volume 

entry 1 

address device 

block 

1 

extent 

entry 

extent 

entry 


Legend: 

d Indicates pointer to. 

Note: 

X The offset is taken from the beginning of the entry. 


Figure 2. Control Block Chain, Initialization 
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Register 1 




Notes: 1. The offset is taken from the beginning of the entry. 
2. @ is pointer to. 


Figure 3. Control Block Chain* Input/Output Processing 
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SRB/IOSB Skeletons 


First MMSV 

Eye Catcher (EBCDIC ICYMMSV1) 


t LOCK 
11st Segment 
t Next Owned MMSB 


Pointer to MMSB 

t Next Segment 
Segment Lock 


l—Next Seg 
«■ * • 


Segment Header 




Last segment header is a dummy 
of all zeros. 


t Block 


X'8000 

0000 ' 


t Next MMSV 


0000 FFFB = MMS entry not used 
0000 FFFD * Held by event listen exit 
0000 FFFF = Storage block available 
8000 0000 « Entry points to next MMSV 

0000ASID » Locked-caller'sASID 


Eye-Catcher 


Note: ICYMMSV1 is the first MMSV. 


Figure 4. Media Manager Storage Block Linkages 
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DESCRIPTIONS OF CONTROL BLOCKS AND DATAWARE AS 

Following is a brief description of control blocks and data 
areas needed for diagnosis in the media manager. 


ICYCPL: CONVERT PARAMETER LIST 

Pointed to by: Register 1. 

Storage Locations Specified by calling program. 

Descriptions Used by the convert routines to change RBA to 
CCHHR and vice versa. 

Created: By calling program. 

Releaseds By calling program. 


ICYEDB: EXTENT DEFINITION BLOCK 

Pointed to bys ICYMMIB. 

Storage Locations Specified by calling program or obtained in 
MMINIT processing. 

Descriptions Describes data set extents. There are one or more 
extent definition blocks for each data set. The extent 
descriptions in an EDB are in ascending RBA sequence. For each 
extent# the description includes the address of the associated 
LPMB, the starting and ending RBA/ and the address of the UCB 
for the device associated with this extent. 

Created: By execution of the MMINIT macro. 

Released: By calling program. 


ICYIDEVB: MEDIA MANAGER INITIALIZATION DEVICE BLOCK 

Pointed to by: ICYIPLST. 

Storage Location: Specified by calling program. 

Description: Contains device-related data set information for a 
device type. Includes the length of a block/ the unit of 
allocation/ the physical block size/ the control interval size/ 
and the control area size for a specific device type. 

Created: By calling program. 

Released: By calling program. 


ICYIPLST: MEDIA MANAGER INITIALIZATION PARAMETER LIST 

Pointed to by: Register 1. 

Storage Location: Specified by calling program. 

Description: Has a pointer to the MMIB. Contains data set 
information for one or more volumes. Each volume entry includes 
the addresses of the unit control block (UCB) and device block 
for the device on which the volume is to be mounted; the low and 
high RBAs; and the beginning and ending cylinder and head 
addresses. 

Created: By calling program. 

Released: By calling program. 
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XCYLPMB: LOGICAL-TO-PHYSICAL MAPPING BLOCK 

Pointed to by: ICYEDB. 

Storage Location: Specified by calling program or obtained in 
MMINIT processing. 

Description: Maps the descriptions of the data set extents in 

an EDB to the physical characteristics of the device type on 
which the volume resides. 

Created: By execution of the MMINIT macro. 

Released: By calling program. 


XCYMME: MEDXA MANAGER INTERFACE BLOCK EXTENSION 

Pointed to by: ICYMMIB, ICYMME. 

Storage Location: Specified by calling program. 
Description: Describes an extension of MMIB storage. 
Created: By calling program. 

Released: By calling program. 


ICYMMIB: MEDIA MANAGER INTERFACE BLOCK 

Pointed to by: ICYMMPB, ICYIPLST, Register 2. 

Storage Location Register 2: Specified by calling program. 

Description: Provides linkages between the media manager and 

the calling program requesting I/O services. Includes pointers 
to the EDB and LPMB, the length of those blocks, and sub-pool 
information; and the addresses of the calling program's exit 
routines. 

Created: By calling program. 

Released: By calling program. 


ICYMMPB: MEDIA MANAGER PROCESS BLOCK 

Pointed to by: I0SB CIOSUSE); register 11 for the majority of 
media manager processing. 

Storage Location: System queue area, within an MMSB. 

Description: Describes the process being performed. Flags 

indicate whether the process is read, update-write, 
format-write, or pre-format. A 1-byte module identifier in 
field MMPMODID of the MMPB at offset X'lC' identifies the last 
media manager module in control. 

Created: During request initialization. 

Released: At request termination. 
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DATA AREAS 


MMPB 


Offset 

Dec.(Hex.) 

Length 

Name 

Description 

0 (0) 

564 

MMPB 

MEDIA MANAGER PROCESS BLOCK 

0 (0) 

4 

MMPBID 

EBCDIC IDENTIFIER 'MMPB* 

4 (4) 

12 

MMPBPARM 

INPUT PARAMETERS R0, Rl, R2 

4 (4) 

4 

MMPREG0 

REGISTER 0 AT ENTRY 

4 (4) 

3 

MMPFLG1 

INPUT FLAGS 


1»•» •••• 

MMPNBFCK 

DO NOT DO BUFFER ADDRESS CHECK 


• 1 • * • • • • 

MMPMSRT 

DO NOT SORT MMRE CHAIN 


• • X • •••• 

MMPREAL 

MMRE HAS REAL (NOT VIRTUAL) 
BUFFER ADDRESSES 


• •«X • • * * 

MMPNFRR 

FRR NOT WANTED FOR FRONT END 
(USE EUT FRR) 


«••• X • • • 

MMPNDSBL 

DO NOT DISABLE IN FRONT END 


* • • • * X • • 

MMPACSEQ 

SEQUENTIAL ACCESS 


• ••« • •X • 

MMPDEPNO 

REQUESTS ARE NOT DEPENDENT 


• ••« • • • X 

MMPBYPCL 

BYPASS CACHE LOAD 

7 (7) 

1 

MMPKEY 

PROTECT KEY FOR I/O 

8 (8) 

4 

MMPMMRE 

POINTER TO MMRE CHAIN 

12 (C) 

4 

MMPMMIB 

POINTER TO MMIB 

16 (10) 

4 

MMPUSAV 

USERS SAVE AREA REGISTER 

20 (14) 

4 

MMPASID 

ASID FOR COMPARE AND SWAP 

20 (14) 

2 

MMPASIDR 

RESERVED 

22 (16) 

2 

MMPASIDH 

ASID USED FOR SDUMP 

24 (18) 

4 

MMPPTCBA 

PURGE TCB ADDRESS 

28 (1C) 

96 

MMPCLEAR 

PORTION OF MMPB TO BE CLEARED 

AT MMPB CREATION 

28 (1C) 

1 

MMPMODID 

FUNCTION CODE PORTION OF THE 
RETURN CODE 

29 (ID) 

1 

MMPFLG2 

GENERAL FLAGS (SOME ARE 

DECLARED BELOW AS ABNORMAL) 


1 . 

MMPERR 

AT LEAST ONE MMRE IN THE 

REQUEST WAS IN ERROR 
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Offset 

Dec.(Hex.I 

Length 

Name 

Description 


1 . 

MMPDEP 

DEPENDENCIES EXIST BETWEEN 

MMRES IN THE REQUEST 


* ’ 1 * 

MMPNTERM 

DO NOT ENTER USERS TERMINATION 
ROUTINE 


•••X •••• 

MMPFMTWR 

FORMAT WRITE REQUEST 


• ••• 1 • • • 

MMPPRFMT 

PREFORMAT REQUEST 


• ••• • 1 • • 

MMPFINIO 

ALL IOSBS FINISHED 


• • • • » • X • 

MMPPCK 

PCK IN IOS OR FRR ENTERED 


• '••• • • • 1 

MMPPUR6E 

PURGE ENABLED 

29 (ID) 

1 

MMPABNL 

FLAGS DECLARED ABNORMALLY 


X • • • • • • • 

MMPERRAB 

SAME AS MMPERR 


.111 11.. 




• ••• • • X • 

MMPPCKAB 

SAME AS MMPPCK 

30 (IE) 

1 

MMP2FLG 

FLAGS FOR USE BY SECOND LEVEL 
MODULES 

31 (IF) 

1 

MMPFLG3 

RESERVED 


1. 

MMPIOP 

I/O PREVENTED 


.111 1111 


NOT USED 

32 (20) 

4 

MMPMMSB 

ADDRESS OF FIRST OWNED MMSB 
(LAST MMSB ACQUIRED) 

36 (24) 

4 

MMPFSEG 

ADDRESS FIRST STORAGE SEGMENT 
(LAST SEGMENT ACQUIRED) 

40 (28) 

4 

MMPFREEP 

FIRST FREE BYTE 

44 (20 

4 

MMPFREEL 

FREE LENGTH 

48 (30) 

4 

MMPLISNP 

ADDRESS OF LIST ELEMENT FOR 

NEXT Cl TO PROCESS 

52 (34) 

4 

MMPBLKCT 

PHYSICAL RECORDS 

56 (38) 

4 

MMPIOSBS 

NUMBER OF IOSBS STARTED 

60 (30 

4 

MMPIOSBF 

NUMBER OF IOSBS FINISHED 

64 (40) 

2 

MMPIOSBC 

NUMBER OF IOSBS 

66 (42) 

2 

MMPLISTC 

NUMBER OF ELEMENTS IN MMPLIST 

68 (44) 

2 

MMPCPAL 

LENGTH OF CHANNEL PROGRAM AREA 

70 (46) 

1 

MMPFRLK 

LOCK FOR ICYFREE. 00 = 

DISABLED, FF = ENABLED 

71 (47) 

1 

MMPSMSK 

SAVE AREA FOR SYSTEM MASK 

72 (48) 

4 

MMPCPAP 

ADDRESS CHANNEL PROGRAM AREA 

76 (40 

4 

MMPRETCD 

RETURN CODE 
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Offset 

Dec.(Hex.) 

Length 

Name 

Description 

76 (40 

2 

MMPRETSS 

SSSS 

78 (4E) 

1 

MMPRETFF 

FF 

79 (4F) 

1 

MMPRETCC 

CC 

80 (50) 

4 

MMPURET 

RETURN CODE FROM USER 

84 (54) 

4 

MMPMMPT 

ADDRESS OF MMPT ENTRY 

88 (58) 

4 

MMPIPIB 

ADDRESS OF IPIB IF PURGE IN 
PROGRESS 

92 (50 

4 

MMPUPURG 

ADDRESS OF USER PURGE EXIT 

96 (60) 

4 

MMPFRRWA 

ADDRESS OF FRR WORK AREA 

100 (64) 

24 

MMPLIST1 

FIRST ELEMENT IN MMPLIST 

124 (70 

232 

MMPI01 

FIRST IOSB AREA 

356 (164) 

72 

MMPSMSAV 

SAVE AREA FOR CALLING ICYSTOR 
AND ICYRBA 

428 (1AC) 

64 

MMPSAVE2 

GENERAL SAVE AREA 

492 (1EC) 

8 

MMP2WA 

WORK AREA 

500 (1F4) 

64 

MMPSAVE3 

SAVE AREA FOR FRONT END WHEN 
BACK END MAY BE PROCESSING. 

MAY NOT BE USED BY BACK END 


HHPB LIST ELEMENT 


Offset 

Dec.(Hex.) 

Length 

Name 

Description 

0 (0) 

24 

MMPLIST 

Cl LIST ELEMENTS FOR WHICH I/O 
WILL BE DONE 

0 (0) 

4 

MMPMMREP 

ADDRESS OF THE MMRE 

4 (4) 

1 

MMPLISTF 

FLAGS 


1 • • • • * • • 

MMPLREQE 

LAST LIST ENTRY FOR REQUEST 


•1*» 

MMPLSEGE 

LAST LIST ENTRY FOR SEGMENT 


• •X* • •«• 

MMPLWRIT 

WRITE THIS Cl (OFF FOR READ) 


• ••1 X • • • 

MMPRSV01 

RESERVED 


• ••• 1 1 * • 

MMPLSP 

SEARCH PREV. CHANNEL PROGRAM 


• •»» • • X • 

MMPLCNTL 

THIS IS A CONTROL ELEMENT 


• ••• • * *X 

MMPLXERR 

EXTENT ERROR FOR LIST ELEMENT 

5 (5) 

1 

MMPLCI 

RELATIVE Cl IN MMRE (0 TO 14) 

6 (6) 

8 

MMPLB 

BEGINNING BBCCHHR & SECTOR 
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Offset 

Dec.(Hex.) 

Length 

Name 

Description 

6 (6) 

7 

MMPLBSK 

BEGINNING BBCCHHR 

6 (6) 

2 

MMPLBB 

BEGINNING BB 

6 (6) 

i 

MMPLSTF1 

FLAGS SET BY RBA CONVERT FOR 
CHANNEL PROGRAM BU 


i... 

.... 

MMPLCTIG 

THIS Cl CONTIGUOUS WITH PRIOR 

Cl 


.i.. 

• • • < 

MMPLSCYL 

Cl ON SAME CYLINDER AS 

PREVIOUS Cl 


. .i. 

» • • • 

MMPLSTRK 

Cl ON SAME TRACK AS PREVIOUS 

Cl 


.. .i 

• III 

MMPLSEXT 

Cl IN SAME EXTENT AS PREVIOUS 

Cl 


• it 

1. .. 

MMPLSRW 

Cl IS SAME READ/WRITE 

OPERATION AS PREVIOUS Cl 


• • • « 

.1.. 

MMPLECKD 

EXTENT IF FOR FULL ECKD 


• • • • 

.1. . 

MMPLLR 

LOCATE RECORD SUPPORTED 


• « • • 

. .1. 

MMPLDE 

DEFINE EXTENT SUPPORTED 


i • « • 

. . .1 

MMPRSV02 

RESERVED 

7 (7) 

i 

MMPLSTF2 

FLAGS FOR USE BY CHAN PROG 

BUILD 

8 (8) 

5 

MMPLBCHR 

BEGINNING CCHHR 

8 (8) 

4 

MMPLBRBA 

BEGINNING RBA 

8 (8) 

4 

MMPLBCH 

BEGINNING CCHH 

8 (8) 

2 

MMPLBC 

BEGINNING CC 

10 (A) 

2 

MMPLBH 

BEGINNING HH 

12 (C) 

1 

MMPLBR 

BEGINNING R 

13 (D) 

1 

MMPLSSEC 

STARTING SECTOR 

14 (E) 

6 

MMPLE 

ENDING CCHHR & SECTOR 

14 (E) 

5 

MMPLECHR 

ENDING CCHHR 

14 (E) 

4 

MMPLECH 

ENDING CCHH 

14 (E) 

2 

MMPLEC 

ENDING CC 

16 (10) 

2 

MMPLEH 

ENDING HH 

18 (12) 

1 

MMPLER 

ENDING R 

19 (13) 

1 

MMPLESEC 

ENDING SECTOR 

20 (14) 

4 

MMPLEDBP 

ADDRESS OF EDB EXTENT FOR THIS 
CONTROL INTERVAL 

20 (14) 

4 

MMPLNEXT 

ADDRESS OF MORE LIST ELEMENTS 
(VALID IF MMPLCNT ON) 
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Offset 

Dec.(Hex.) 

Length 

Name 

Description 

0 (0) 

232 

MMPIO 

SRB/IOSB AREA. THE IOSB IS THE 
FIRST ITEM IN THE AREA AND 
IOSUSE POINTS TO THE MMPB 

0 (0) 

108 

MMPIOSB 

IOSB 

108 (60 

44 

MMPSRB 

SRB 

152 (98) 

4 

MMPIONP 

ADDRESS OF NEXT MMPIO AREA 

156 (90 

5 

MMPIOCHR 

CCHHR WORK AREA FOR USE BY 

NORMAL APPENDAGE 

156 (90 

2 

MMPIOC 

CC 

158 (9E) 

2 

MMPIOH 

HH 

160 (AO) 

1 

MMPIOR 

R 

161 (Al) 

1 

MMPI0F2 

FOR USE BY DIE AND APPENDAGES 

162 (A2) 

2 

MMPI0F1 

FLAGS SPECIFIC TO THIS IOSB 


1 • i • «••• 

MMPIOERR 

AT LEAST ONE MMRE IN ERROR 


• 1 • • •••• 

MMPCPINC 

SEGMENT HAS BEEN BROKEN FOR 
ERROR RECOVERY AND INCOMPLETE 
WHEN I/O FINISHES 

164 (A4) 

64 

MMPIOSAV 

SAVE AREA FOR APPENDAGES 

228 (E4) 

4 

MMPCFRBA 

ADDRESS OF FIRST Cl LIST ENTRY 
FOR PORTION OF THE SEGMENT 
CURRENTLY SCHEDULED TO IOS 


CROSS-REFERENCE FOR MMPB 


Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

offset/ 

Equ Value 
Dec.(Hex.) 

MMPABNL 

29 (ID) 

MMPACSEQ 

4 X'04' 

MMPASID 

20 (14) 

MMPASIDH 

22 (16) 

MMPASIDR 

20 (14) 

MMPB 

0 (0) 

MMPBID 

0 (0) 

MMPBLKCT 

52 (34) 

MMPBPARM 

4 (4) 

MMPBYPCL 

4 X*01' 

MMPCFRBA 

228 (E4) 

MMPCLEAR 

28 (1C) 

MMPCPAL 

68 (44) 

MMPCPAP 

72 (48) 

MMPCPINC 

162 X'40' 

MMPDEP 

29 X*40' 

MMPDEPNO 

4 X'02* 

MMPERR 

29 X'80' 

MMPERRAB 

29 X'80' 

MMPFINIO 

29 X'04’ 

MMPFLG1 

4 (4) 

MMPFLG2 

29 (ID) 

MMPFLG3 

31 (IF) 

MMPFMTWR 

29 X*10' 

MMPFREEL 

44 (20 

MMPFREEP 

40 (28) 

MMPFRLK 

70 (46) 
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Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

MMPFRRHA 

96 (60) 

MMPFSEG 

36 (24) 

MMPIO 

0 (0) 

MMPIOC 

156 (90 

MMPIOCHR 

156 (90 

MMPIOERR 

162 X'80* 

MMPI0F1 

162 (A2) 

MMPI0F2 

161 (Al) 

MMPIOH 

158 (9E) 

MMPIONP 

152 (98) 

MMPIOP 

31 X'80 * 

MMPIOR 

160 (AO) 

MMPIOSAV 

164 (A4) 

MMPIOSB 

0 (0) 

MMPIOSBC 

64 (40) 

MMPIOSBF 

60 (30 

MMPIOSBS 

56 (38) 

MMPI01 

124 (70 

MMPIPIB 

88 (58) 

MMPKEY 

7 (7) 

MMPLB 

6 (6) 

MMPLBB 

6 (6) 

MMPLBC 

8 (8) 

MMPLBCH 

8 (8) 

MMPLBCHR 

8 (8) 

MMPLBH 

10 (A) 

MMPLBR 

12 (C) 

MMPLBRBA 

8 (8) 

MMPLBSK 

6 (6) 

MMPLCI 

5 (5) 

MMPLCNTL 

4 X'02' 

MMPLCTIG 

6 X'80' 

MMPLDE 

6 X'02' 

MMPLE 

14 (E) 

MMPLEC 

14 (E) 

MMPLECH 

14 (E) 

MMPLECHR 

14 (E) 

MMPLECKD 

6 X'04' 

MMPLEDBP 

20 (14) 

MMPLEH 

16 (10) 

MMPLER 

18 (12) 

MMPLESEC 

19 (13) 

MMPLISNP 

48 (30) 

MMPLIST 

0 (0) 

MMPLISTC 

66 (42) 

MMPLISTF 

4 (4) 

MMPLIST1 

100 (64) 

MMPLLR 

6 X'04* 

MMPLNEXT 

20 (14) 

MMPLREQE 

4 X'80' 

MMPLSCYL 

6 X'40* 

MMPLSE6E 

4 X'40* 

MMPLSEXT 


MMPLSP 

4 X'04* 

MMPLSRW 

6 X'08* 

MMPLSSEC 

13 (D) 

MMPLSTF1 

6 (6) 

MMPLSTF2 

7 (7) 

MMPLSTRK 

6 X'20 * 

MMPLWRIT 

4 X'20' 

MMPLXERR 

4 X'Ol' 

MMPMMIB 

12 (C) 

MMPMMPT 

84 (54) 

MMPMMRE 

8 (8) 

MMPMMREP 

0 (0) 

MMPMMSB 

32 (20) 

MMPMODID 

28 (1C) 

MMPNBFCK 

4 X'80‘ 

MMPNDSBL 

4 X'08' 

MMPNFRR 

4 X'10' 

MMPNSRT 

4 X'40 * 

MMPNTERM 

29 X'20' 

MMPPCK 

29 X'02' 

MMPPCKAB 

29 X'02' 

MMPPRFMT 

29 X'08' 

MMPPTCBA 

24 (18) 

MMPPURGE 

29 X'Ol' 

MMPREAL 

4 X'20* 

MMPREGO 

4 (4) 

MMPRETCC 

79 (4F) 

MMPRETCD 

76 (40 

MMPRETFF 

78 (4E) 

MMPRETSS 

76 (40 

MMPRSV01 

4 X'18' 

MMPRSV02 

6 X'Ol' 

MMPSAVE2 

428 (1AC) 

MMPSAVE3 

500 (1F4) 

MMPSMSAV 

356 (164) 

MMPSMSK 

71 (47) 

MMPSRB 

108 (60 

MMPUPURG 

92 (50 

MMPURET 

80 (50) 

MMPUSAV 

16 (10) 

MMP2FLG 

30 (IE) 

MMP2WA 

492 (1EC) 
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ICYMMPT: MEDIA MANAGER PURGE TABLE 

Pointed to by: ICYMMPT. 

Storage Location: Nucleus or system queue area. 

Description: Contains addresses of active media manager process 

blocks. 

Created: As required during request processing. 

Released: Not released. 


MMEI 


offset 

Dec.(Hex.) 

Length 

Name 

Description 

0 (0) 

256 

ICYMMPT 

MEDIA MANAGER PURGE TABLE 

0 (0) 

8 

MPTHDR 

HEADER 

0 (0) 

4 

MPTID 

ID = MMPT 

4 (4) 

4 

MPTNEXT 

NEXT MMPT 

8 (8) 

248 

MPTMMPB 

POINTER TO MMPB OR ZERO IF NONE 


CROSS-REFERENCE FOR MMPT 


Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

ICYMMPT 

0 (0) 

MPTHDR 

0 (0) 

MPTID 

0 (0) 

MPTMMPB 

8 (8) 

MPTNEXT 

4 (4) 




ICYMMRE: MEDIA MANAGER REQUEST ELEMENT 

Pointed to by: ICYMMPB, Register 1. 

Storage Location: Specified by calling program. 

Description: Used by the calling program to communicate 

requests for data to the media manager. Flags indicate whether a 
read or a write is requested. Includes the number of control 
intervals in the request/ and the address of the next request 
element/ if applicable. 

Created: By calling program. 

Released: By calling program. 


24 MVS/XA Media Manager Diag. Ref. 


LY26-3965-1 © Copyright IBM Corp. 1980, 1987 








































Restricted Materials of IBM 
Licensed Materials — Property of IBM 

xcymmsb: media manager storage block 

Pointed to by: ICYMMSV. 

Storage Locationt System queue area. 

Descriptions Describes the storage blocks that are owned and 
managed by the media manager. 

Createds As required during request processing. 

Releaseds By ICYELE when signaled by the system resource 
manager if the block is not in use. 


m§& 


Offset 

Dec.(Hex.1 

Length 

Name 

Description 

0 (0) 

4096 

MMSB 

MEDIA MANAGER STORAGE BLOCK 

0 (0) 

16 

MMSHDR 

HEADER 


4 

MMSID 

CHARACTERS MMSB 

4 (4) 

4 

MMSL0CKP 

ADDRESS OF LOCK FOR BLOCK (IN MMSV) 

8 (8) 

4 

MMSFSEG 

ADDRESS OF FIRST SEGMENT 

12 (C) 

4 

MMSMMSB 

ADDRESS OF NEXT MMSB ON OWNED CHAIN 

16 (10) 

4080 

MMSBSEGS 

AREA FOR SEGMENTS 

0 (0) 

16 

MMSBSEG 

ALLOCATED OR FREE SEGMENT 

0 (0) 

16 

MMSSHDR 

SEGMENT HEADER 

0 (0) 

4 

MMSSMMSB 

ADDRESS OF MMSB 

4 (4) 

4 

MMSSCHN 

ADDRESS OF NEXT SEGMENT IN THIS MMSB 

8 (8) 

4 

MMSSUCHN 

ADDRESS OF NEXT SEGMENT USED BY THIS 
REQUEST 

12 (C) 

4 

MMSSASID 

ASID OF THE OWNER OF THIS SEGMENT. 

FFFF IF FREE 

16 (10) 

0 

MMSSSTG 

REST OF SEGMENT 
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Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ i 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 



MMSB 

0 (0) 

MMSBSEG 

0 (0) 

MMSBSEGS 

16 (10) 

MMSFSEG 

8 (8) 

MMSHDR 

0 (0) 

MMSID 

0 (0) 

MMSLOCKP 

4 (4) 

MMSMMSB 

12 '(C) 

MMSSASID 

12 (C) 

MMSSCHN 

4 (4) 

MMSSHDR 

0 (0) 

MMSSMMSB 

0 (0) 

MMSSSTG 

16 (10) 

MMSSUCHN 

8 (8) 


ZCYMMSV: MEDIA MANAGER STORAGE VECTOR 

Pointed to by: ICYMMSV. 

Storage Location: Nucleus or system queue area. 

Description: Contains the addresses of media manager storage 
blocks. 

Created: As required during request processing. 

Released: Not released. 


MMSY 


offset 

Dec.(Hex.) 

Length 

Name 

Description 

0 (0) 

256 

ICYMMSV 

MEDIA MANAGER STORAGE VECTOR 

0 (0) 

256 

MMSVENTS 

INDIVIDUAL ENTRIES 

0 (0) 

8 

MMSVENT 

MMSV ENTRY 

0 (0) 

4 

MMSVL0CK 

LOCK FOR MMSB 


x»• • * * * * 

MMSVCHN 

CHAIN ENTRY (BITS 1 THRU 31 are 0»s) 

4 (4) 

4 

MMSVADDR 

ADDR IF MMSB OR NEXT MMSV 
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CRPSSrREFEREUCE FO R MMS V 


Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.1 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 




0 (0) 

MMSVADDR 

4 (4) 

MMSVCHN 

0 X'80' 

MMSVENT 

0 (0) 

MMSVENTS 

0 (0) 

MMSVLOCK 

0 (0) 

END OF 

MMSV 




XCYMMVT: MEDIA MANAGER VECTOR TABLE 

Pointed to by. CVTMMVT. 

Storage Location. Nucleus. 

Description. Contains addresses of media manager routines* a 
patch area* the first MMSV prefixed by the characters ICYMMSV1* 
and the first MMPT. 

Created. By link-editing media manager into the nucleus. 
Released. Not released. 


MMVT 


Offset 

Dec.(Hex.) 

Length 

Name 

Description 

0 (0) 

2 

MMVT 

MEDIA MANAGER VECTOR TABLE 

0 (0) 

2 

MMVLEN 

TOTAL LENGTH OF MMVT 

2 (2) 

0 

MMVCPYRT 

COPYRIGHT INFORMATION 

2 (2) 

1 


BLANK 

3 (3) 

11 

MMVCOMP 

COMPONENT ID 

0 (0) 

992 

MMVTC 

POINTED TO BY CVTMMVT 

0 (0) 

4 

MMVPATCH 

M/M PATCH AREA LOCATION 

4 (4) 

4 

MMVI0SB 

M/M IOSB SKELETON LOCATION 

8 (8) 

4 

MMVINIT 

M/M INITIALIZATION ROUTINE 

12 (C) 

4 

MMVRDWR 

M/M READ AND UPDATE WRITE 

16 (10) 

4 

MMVFW 

M/M FORMAT WRITE 

20 (14) 

4 

MMVPFMT 

M/M PREFORMAT BY RBA RANGE 

24 (18) 

4 

MMVRBA 

M/M RBA TO CCHHR CONVERT 

28 (1C) 

4 

MMVCCHHR 

M/M CCHHR TO RBA CONVERT 

32 (20) 

4 

MMVMMSRV 

MEDIA MANAGER SERVICES 

36 (24) 

4 

MMV553I 

ADDRESS OF MODULE IGG0553I 
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Offset 
Dec.(Hex.) 


40 (28) 


44 (20 


48 (30) 


52 (34) 


56 (38) 


60 (30 


64 (40) 


68 (44) 


72 (48) 


76 (40 


80 (50) 


84 (54) 


88 (58) 


92 (50 


96 (60) 


100 (64) 


104 (68) 


108 (60 


364 (160 


472 (1D8) 


480 (1E0) 


736 (2E0) 


Length 


Name 

Description 

MMVSM 

M/M STORAGE MANAGER 

MMVELE 

M/M EVENT LISTEN EXIT 

MMVSORT 

M/M REQUEST ELEMENT SORT 

MMVBLIST 

M/M Cl LIST BUILD 

MMVBLDCP 

M/M CHANNEL PROGRAM BUILD 

MMVPFCP 

M/M PREFORMAT CP BUILD 

MMVDIE 

M/M DISABLED INTERRUPT EXIT 

MMVPFDIE 

M/M PREFORMAT DIE 

MMVNRM 

M/M NORMAL END APPENDAGE 

MMVABN 

M/M ABNORMAL END APPENDAGE 

MMVPFAPP 

M/M PREFORMAT APPENDAGE 

MMVPGAD 

M/M TERMINATION ROUTINE 

MMVPURG 

M/M PURGE ROUTINE 

MMVFRR 

M/M FUNCTIONAL RECOVERY ROUTINE 

MMVIEDB 

M/M EDB INITIALIZATION 

MMVILPMB 

M/M LPMB INITIALIZATION 

MMVRSV02 

RESERVED 

MMVPTCH1 

M/M PATCH AREA 

MMVI0SB1 

M/M IOSB SKELETON 

MMVMMSVE 

EYE-CATCHER 

MMVMMSV1 

M/M FIRST STORAGE VECTOR 

MMVMMPT1 

M/M FIRST PURGE TABLE 


Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

MMVABN 

76 (40 

MMVBLDCP 

56 (38) 

MMVBLIST 

52 (34) 

MMVCCHHR 

28 (1C) 

MMVCOMP 

3 (3) 

MMVCPYRT 

2 (2) 

MMVDIE 

64 (40) 

MMVELE 

44 (20 

MMVFRR 

92 (50 

MMVFW 

16 (10) 

MMVIEDB 

96 (60) 

MMVILPMB 

100 (64) 

MMVINIT 

8 (8) 

MMVIOSB 

4 (4) 

MMVI0SB1 

364 (160 

MMVLEN 

0 (0) 

MMVMMPT1 

736 (2E0) 

MMVMMSRV 

32 (20) 
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Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

Name 

Offset/ 

Equ Value 
Dec.(Hex.) 

MMVMMSVE 

472 (1D8) 

MMVMMSV1 

480 (1E0) 

MMVNRM 

72 (48) 

MMVPATCH 

0 (0) 

MMVPFAPP 

80 (50) 

MMVPFCP 

60 (30 

MMVPFDIE 

68 (44) 

MMVPFMT 

20 (14) 

MMVPGAD 

84 (54) 

MMVPTCH1 

108 (60 

MMVPURG 

88 (58) 

MMVRBA 

24 (18) 

MMVRDWR 

12 (C) 

MMVRSV02 

104 (68) 

MVSM 

40 (28) 

MMVSORT 

48 (30) 

MMVT 

0 (0) 

MMVTC 

0 (0) 

MMV553I 

36 (24) 






LY26-3965-1 © Copyright IBM Corp. 1980, 1987 


Data Areas 29 














































Restricted Materials of IBM 
Licensed Materials - Property of IBM 


SERVICE, AIfl.3 


This section contains descriptions of dumps and tools that are 
used to collect and analyze diagnostic information for the media 
manager. 

A program check or other abend that occurs either in the media 
manager or in an exit routine will result in a summary dump of 
the media manager control blocks. This dump is written to the 
SYSl.DUMPxx data set using the SDUMP macro instruction. Also, an 
error record may be written out to SYS1.L0GREC in the event of 
an undetermined error. 

The media manager will provide a dump, using SDUMP, only if the 
operating environment was such that a functional recovery 
routine (FRR) could be established. An FRR is not established 
for functions invoked via the MMCNVT or MMINIT macros. 

Functions invoked via the MMCALL procedure are protected by an 
FRR. 

Figure 5 is a sample of a summary dump. The first area is the 
SUMLIST RANGE, which shows the media manager vector table 
(MMVT). The second area is the range that shows the media 
manager process block (MMPB) that contains information on the 
current status of the media manager request. The third area, 
identified as the SDHA, is the system diagnostic work area and 
contains the name of the function and the name of the module 
last in control. The fourth area is the first register area, 
which starts with the registers in the interrupt handler save 
area and continues with the registers in the SDWA. 


IWLlA ftABAGBS, 5752-DIM-CR, S DO IIP ISSUED BY ICTFBB NODDLE IEAYTSDT DATE 07/15/80 TINE 11.57.36 PAGE 0005 

- SOBRAST DORP OUTPUT FOB ASID 0003 


—-— SDBLIST BARGE -BBCOBD ID X*002E» COPIED PBOfl DORP ADDBBSS 0001D0C0 FOB A LEBGTB OP X*00000330* BYTES• 



- SORLXST AAVGE - RECORD ID 1*002E* COPIED FROB DUBP ADDBESS 00PEC01O FOB A LENGTH OF X*00000598* BYTES. 



Figure 5 (Part 1 of 2). Summary Dump Sample 
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-S DdA 


BBCOfiD ID X • 00 38 • COPIED PBOR DORP ADDRESS 0082 B 358 POR A LENGTH OF X * 00000200 * BYTES. 


flBDI A RANAGSb, 5752 -DR 1 -CH, SDORP ISSOED BI ICTFBR 


RODOLE 1 EAVT 5 DT DATE 07 / 15/80 TIRE 11 . 57.36 PAGE 0017 


0062 P 340 
00 8 2 E J 60 
GO 62K380 
00o2^310 
0062 EJC 0 

00 b 2 E 42 Q 
0082 E 440 
00620460 
00 o 2 P 480 
00 d 2 :.** AO 
»e 

00tt2i4 EO 

m ms 

00 8 2E540 


OUGgglOO 00000000 00000000 00000000 
OOFEC 4 BO 00 rfiC 260 6002 AAB 4 00002 A 68 
00 D 26 JS 8 00 PECO 20 50081 P 86 00000001 
070 C 1000 00000005 000 h 0006 007 P 9 DB 4 
OOOuJv-OO 00 B 26356 008 26 400 OOPEC 084 
OOPEC 26 b 000220 C 8 40081 E 90 00 PEC 020 
00000000 00000000 00000000 00000000 
400 J 0001 00000040 00000000 0062 E 4 EC 
OOOOuoOO 00000000 00000000 00000000 
C 6 D 4 E 340 C 9 C 3 E 8 D 7 C 6 C 1 D 7 D? C 9 C 3 E 8 C 6 
OOUOCOOO 00000000 00000000 00000000 
LINES PBOR 0082 E 4 C 0 TO 008 2 E 4 E 0 ARE 
OOOOOvOO 000691 CA 00344032 D 4 C 5 C 4 C 9 

oooSSoSo £8888888 1*885888 8588885* 

OOGOoGOO 00000000 00000000 00000000 


00000 C 7 C 900 C 6000 
00000000 00 b 26358 00 B 26400 SSFBC 0 B 4 

88558*88 ooSooooo 888 tm 88888888 

070 C 0000 0001 E 370 00040006 007 P 9 DB 4 
00 PEC 4 b 0 00 PEC 260 6002 AAB 4 00002 A 68 
00 B 26356 O 0 PEC 020 50081 PB 6 00000001 
06000000 00000000 @0000000 00000000 
00000000 00400000 00000000 00000000 
00000000 30000000 00030003 C 9 C 3 BBD 7 
D 9 D 94040 OO 02 B 490 00000000 00000000 
00000000 00000000 00000000 00000000 
THE SARE AS THE ABOVE LINE 


•PRT ICTPPAPPICYPBR 


.10 TP' 


C 140 D 4 C 1 D 5 C 1 C 7 C 5 D 96 B 40 P 5 P 7 P 5 F 260 •.RED IA RANAGEH. 5752 . 

E 2 E 4 C 5 C 4 4 OC 2 E 04 O C 9 C 3 E 8 C 6 D 9 D 90000 •DR 1 .CR. SDORP ISSUED BI ICYPBB.. 
00 C 00000 00000000 00000000 00000000 *. 


00000000 00000000 


-REGISTER AREA 


- RECORD ID 1 * 0030 * COPIED PFOR DORP ADDRESS 00 PPCB 50 POP A LENGTH OP X* 00001000 * BYTES• 


COPPC 2 60 
00 PPC 560 
00 PPCS 60 
00 PPCEA 0 
00 PPCECO 
OOPPCEEO 
♦*••••»* 
OOPPDO 40 
00 PPD 060 
OOPPDOBO 
OOPPDO AO 
•••••« ** 
C 0 PPD 0 E 0 
OOPFDIOO 
0 OPPD 120 
0 OPFD 140 
00 PrD 160 
00 FPD 160 

*4«***M 

OOPPD 1 EO 

ooppoiSf 

0 OPPD 260 

00 PFD 260 

oopp»lc8 


OOPPD 320 

«•*•««** 


00000000 gooooooo 00000000 oooooooo 

D 0 PLC 4 B 0 0 OPEC 26 O 6002 AAE 4 00002 A 6 B 
OOB 26358 00 PECO 20 50081 FB 6 00000001 
0 P 3 D 7 C 00 OOOOOOOO OOOOOOOO OOOOOOOO 

oooooooo oooooooo oooooooo oooooooo 

LINES PBOR OOPPCrOO TO OOPPD 040 ABE 
00 PP 9908 OOOOOOOO OOOOOOOO OOOOOOOO 
00000000 OOOOOOOO OOOOOOOO OOOOOOOO 
000003 P 2 34 A 42000 OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
LINES PBOR OOPPDOCO TO OOPPDOEO ARE 

OOOOOOOO OOOOOOOO oooooooo oooooooo 
OOOOOOOO OOOOOOOO 00004000 07140000 
ffTTYtr? OOOOOOOO OOOOOOOO 00 PP 9578 
8002777 C 8002 B 3 AE B 00283 B 2 8002865 C 
OOOOOOOO 0 OPPAPAO B 002884 A OOOOOOOO 
OOOOOOOO OOOOOOOO 00000000 OOOOOOOO 
LINES PBOR 00 PPD 1 A 0 TO 90 PPD 1 E 0 ARE 
OOOOOOOO OOOOOOOO 00000000 OOOOOOOO 
00008000 00025850 OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
LINES PBOR O 0 PPD 240 TO 00 FPD 260 ABE 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOPDD 6 P 8 003 DE 6 P 8 

88888888 88888888 88888888 88888888 

oogooooo°oooooooo s oooooooo P o^oooooc 
oooooooo oooooooo oooooooo oooooooo 

LINES PBOR 00 PPD 340 TO 00 PFD 360 ABE 


oooooooo oooooooo oooooooo 

OOOOOOOO 00 B 2635 B 00 B 26400 
00 PEC 268 G 00220 C 8 40081 E 90 
070 C 1000 00000005 00040006 
OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 
THE SARE AS THE ABOVE LINE 
OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 
000003 P 2 4 D 8 D 1000 OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 
THE SARE AS THE ABOVE LINE 
OOOOOOOO OOOOOOOO 00000003 
G 0002 A 60 00014 AAO 00 PF 68 3 b 
OOOOOOOO 5002 ABPC 800272 AE 
8002886 C OOOOOOOO OOOOOOOO 
303 DC 78 90029426 00014 A 78 
OOOOOOOO OOOOOOOO OOOOOOOO 
THE SARE AS THE ABOVE LINE 
D 7 C 3 C 3 C 1 C 6 C 6 rOPl POPOPOPB 
OOOOOGOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 
THE SARE AS THE ABOVE LINE 
80000000 OOOOOOOO OOOOOOOO 
00 PDA 180 goB 180 00 PB 8 C 28 

W00000 
LINE 
“30000 
7000 


OOOOOOOO 

00 FBC 084 

00 PBC 020 

007 P 9 DU 4 

OOOOOOOO 

OOOOOOOO 

OOOOOOOO 

OOOOOOOO 

OOOOOOOO 

OOOOOOOO 

OOOOOOOO 

0001470 C 

0002759 E 

0001479 C 

00001000 

OOOOOOOO 

£0000000 

oooooooo 




THE SARE AS THE ABOVE 
OOOOOOOO OOOOOOOO ~ 

OOOOOOOO OOOOOOOO _ 

THE SABE AS THE ABOVE LINE 



.D...B ....0 .B. ...H 


■PCCAPPO 100080168 


.08. .N8.Q 


Figure 5 (Part 2 of 2). Summary Dump Sample 
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AEP E NPIXt -RETURN COPE ? 


For certain errors that may occur when a media manager function 
is invoked^ or a termination routine is called/ return codes 
will be provided. 

Return codes are located in register 15 when control is returned 
to the program that called the media manager; in register zero/ 
when the media manager calls an exit routine. 

Return codes will have the format ccccffss ; cccc is the return 
code/ ff is the module that detected the error/ and ss is a 
status byte. 

The status byte represents the followings 

ffll-ftoM Error Description 

00 No error. 

04 Naming. 

08 Extent error. 

0C Logic error. 

10 Permanent I/O error. 

14 Error can v t be determined. 


In combination with one of these status bytes/ return codes in 
the cccc field indicate the following errors* 


fififig-ff Error Des cription 


0000 

— 

00 

0000 

— 

04 

0010 


08 

0014 

— 

08 

0018 

— 

08 

0420 

— 

08 

0424 

— 

08 

0428 

— 

08 

042C 

— 

08 

0004 

— 

OC 

0008 

— 

OC 

0010 

— 

OC 

oooc 

— 

OC 

001C 

— 

OC 

0020 

— 

OC 

0024 

— 

OC 

0400 

—— 

OC 

0408 

— 

OC 

0410 

— 

0C 

0418 

— 

0C 

0434 

— 

OC 

0010 

— 

10 

0020 

— 

10 

0030 

— 

14 

0034 

— 

14 


No errors. 

No errors. DIE exit is receiving control in SRB 
mode. 

The end of a Cl is out of its extent. 

Extent not found. 

Extent not active. 

Overlapping extents. 

Invalid ending RBA. 

Block size is too large for the device. 
Inconsistent Cl sizes. 

Two writes to the same RBA. 

Two reads to the same buffer. 

MMRE specifies output but MMIB specifies input 
only. 

An MMRE specifies multiple CIs to be sorted. 

Load real address error. Buffers not fixed. 
Starting RBA not on Cl boundary—preformat only. 
Insufficient storage for channel program due to 
media manager storage constraints. 

6ETMAIN error for LPMB. 

Insufficient storage supplied for LPMB. 

GETMAIN error for EDB. 

Insufficient storage supplied for EDB. 

The parameter list is incomplete. 

I/O prevented. 

Permanent I/O error. 

Error can't be determined. 

Indeterminate error - I/O has been started. 
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The ff field of the return code identifies the module that has 
detected the error. These codes may also be found in the 
MMPMODID field of the MMPB. 


ff field Module 


— 

ICYMMSRV 

— 

ICYMMVTC 

— 

ICYMSTAE 

01 

ICYRDWR 

02 

ICYFW 

03 

ICYPFMT 

04 

ICYRBA 

05 

ICYCCHHR 

06 

ICYST0R 

07 

ICYSORT 

08 

ICYBLIST 

09 

ICYELE 

0A 

ICYBLDCP 

0B 

ICYPFCP 

OC 

ICYDIE 

0D 

ICYPFDIE 

0E 

ICYNRM 

OF 

ICYABN 

10 

ICYPFAPP 

11 

ICYPGAD 

12 

ICYPURG 

13 

ICYFRR 

40 

ICYINIT 

41 

ICYIEDB 

42 

ICYILPMB 
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ACDS* alternate control data set. 

APAR. authorized program analysis 

report. 

CCHHR. cylinder-cylinder head-head 

record. 

CDS. control data set. 

Cl* control interval. 

CSI* consolidated software 

inventory. 

CVT* communication vector table. 

DASD* direct access storage device. 

DIE* disabled interrupt exit. 

EDB* extent definition block. 

ENF* event notification facility. 

ESQA* extended system queue area. 

EWS* early warning system. 

FMID* function modification 

identifier. 

FRR. functional recovery routine. 

IOS* I/O supervisor. 

IOSB* I/O supervisor block. 

JCL* job control language. 


K* 1024 (a kilobyte=1024 bytes). 

LPMB* logical-to-physical mapping 

block. 

MMIB* media manager interface block. 

MMPB* media manager process block. 

MMPT* media manager purge table. 

MMRE* media manager request element. 

MMSB* media manager storage block. 

MM$V« media manager storage vector. 

MMVT* media manager vector table. 

RBA* relative byte address. 

RMID* replace module identifier. 

SDWA* system diagnostic work area. 

SMP* System Modification Program. 

SMP/E* System Modification Program 

Extended. 

SRB* service request block. 

SRM* system resource manager. 

SSF* Software Support Facility. 

UCB* unit control block. 

VSM* virtual storage manager. 
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INDEX 



ACB 8 

ACDS, defined 34 
APAR, defined 34 


m 

CATREAD 8 
CATUPDT 8 
CCHHR, defined 34 
CDS/ defined 34 
channel programs 3 
Cl/ defined 34 
CNVT function 3/ 5 
CONNECT 8 
control blocks 12 
description 16 
linkages 13 

control interval elements 5 
CSI, defined 34 
CVT/ defined 34 
COD abend 6 



DASD/ defined 34 
data areas 12 
description 16 
device architecture 3 
device characteristics 6 
Diagnosis Reference 1 
how to use 1 
preface 1 
DIE/ defined 34 
DISCONNECT 8 


m 

EDB 6/ 16/ 17 
EDB/ defined 34 
ENF 9 

ENF, defined 34 
ESQA/ defined 34 
ENS/ defined 34 
EXTEND 8 

extent definition blocks 6 


FMID, defined 34 
FMTWR function 3/ 5 
FRR 5 

FRR, defined 34 
function 1 
CNVT 5 

finding modules in 1 

FMTWR 5 

INIT 6 

MMSYSTEM 6 

PFMT 7 

RDNR 7 

SRV 8 

functional description 5 
functional recovery routine 5 


m 


ICYABN 6/ 9 
ICYBLDCP 7, 9 
ICYBLIST 5, 7/ 9 
ICYCCHHR 5/ 9 
ICYCCHHR. 5 
ICYCPL 5 

ICYCPLi Convert Parameter List 16 
ICYDIE 9 
ICYDIE/ICYNRM 6 

ICYEDBt Extent Definition Block 16 
ICYELE 6/ 10 
ICYFRR 6/ 10 
ICYFW 10 

ICYIDEVB* Media Manager Initialization 
Device Block 16 
ICYIEDB 10 
ICYILPMB 10 
ICYINIT 6/ 10 

ICYIPLST t Media Manager Initialization 
Parameter List 16 

ICYLPMB* Logical-to-Physical Mapping 
Block 17 

ICYMMEi Media Manager Interface Block 
Extension 17 

ICYMMIBt Media Manager Interface 
Block 17 

ICYMMPB: Media Manager Process Block 17 
ICYMMPT« Media Manager Purge Table 24 
ICYMMREi Media Manager Request 
Element 24 

ICYMMSB * Media Manager Storage Block 25 
ICYMMSRV 8, 10 

ICYMMSVt Media Manager Storage 
Vector 26 

ICYMMVTt Media Manager Vector Table 27 

ICYMSTAE 10 

ICYNRM 10 

ICYPFAPP 7 

ICYPFCP 10 

ICYPFDIE 7/ 10 

ICYPGAD 6, 7, 10 

ICYPURG 6/ 10 

ICYRBA 5/ 10 
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ICYRDMR 11 
ICYSORT 11 
ICYSTOR 5, 7, 11 
INIT function 3/ 6 
IOS 9 

10$, defined 34 
IOSB 17 

IOSB, defined 34 
10SUSE 17 


m 

JCL, defined 34 


tu 

PFMT function 3, 7 
PURGE HALT 6 

m 

RBA, defined 34 
RDHR function 3, 7 
relative byte addresses 
RMIO, defined 34 



K, defined 34 



linkages, control block 13 
logical-to-physical mapping blocks 6 
LPMB 6, 17 
LPMB, defined 34 


l~"~l 


media manager 3 

control blocks 12 
data areas 12 
module directory 9 
overview 3 
service aids 30 


MMIB 

16 


MMIB, 

defined 

34 

MMPB 

5 


MMPB, 

defined 

34 

MMPMODID 17 


MMPT, 

defined 

34 

MMRE, 

defined 

34 

MMSB, 

defined 

34 

MMSV, 

defined 

34 


MMSYSTEM function 3, 6 
MMVT, defined 34 
module directory 9 
modules 2 

finding the function 2 
MSWA 8 


SDHA, defined 34 
service aids 30 
SMP/E, defined 34 
SMP, defined 34 
SRB, defined 34 
SRM 9 

SRM, defined 34 
SRV function 3, 8 
SSF, defined 34 
STARTIO 7 
SVC 26 8 

SYS1.DUMPnn 6 
SYS1.LOGREC 6 


UCB, defined 34 

m 

VSAM 9 
VSM 9 

VSM, defined 34 

m 

work area 8 


, 12 
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